/**
 * Provides the core content management operations.
 * <p>
 * This packages provides the API for accessing content persistence, 
 * including support for versioning, multi-language and publication definition.
 * </p>
 * <p>
 * The entry points for this API are {@link lumis.content.core.IContentManager}
 * (available in {@link lumis.content.ContentManagerFactory#getContentManager()})
 * and {@link javax.persistence.EntityManager} (available in
 * {@link lumis.portal.manager.ManagerFactory#getEntityManager()}), that may
 * be used on entities in this package.
 * </p>
 * <p>
 * The {@link lumis.content.core.Content} object represents a content. A content
 * belongs to a service instance. When the service instance is deleted, all its
 * contents are also deleted.
 * </p>
 * <p>
 * Each content may have data in multiple locales. Each locale specific data
 * is represented by {@link lumis.content.core.ContentLocale}. Each
 * ContentLocale may contain authoring comments 
 * ({@link lumis.content.core.ContentComment}) and multiple versions 
 * ({@link lumis.content.core.ContentVersion}) of data.
 * </p>
 * <p>
 * Each {@link lumis.content.core.ContentLocale} has an active version, and
 * may have a published version. The active version is the current version,
 * available for editing and is shown in administration interfaces. The
 * published version is the version that is shown in publication interfaces,
 * if its publication rules (defined in {@link lumis.content.core.ContentPublication})
 * are fulfilled.
 * </p>
 * <p>The following diagram displays the main classes provided by this package
 * and their relationships:
 * <img src="doc-files/content_core_class_diagram.png"/>
 * </p>
 * <p>
 * In the default content process action handlers implementations, the following
 * behaviors are applied:
 * <ul>
 * <li>If multi-language is not enabled, the current user's locale is 
 * used for new contents.</li>
 * <li>If versioning is enabled each time a content is saved, a new <tt>ContentVersion</tt> 
 * is created and made active.
 * </li>
 * <li>If versioning is not enabled the same version is overwritten for each modification.
 * </li>
 * </ul>
 * </p>
 *
 * @since 4.2.0
 * @version $Revision: 12908 $ $Date: 2011-05-09 12:34:59 -0300 (Mon, 09 May 2011) $
 */
package lumis.content.core;